home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 May / Software of the Month Club 1996 May.iso / mac / SRI / General Interest / Virtual Desktop 1.9 / Virtual Desktop Help (text) < prev    next >
Encoding:
Text File  |  1996-03-07  |  70.8 KB  |  1,688 lines  |  [TEXT/R*ch]

  1. Virtual Desktop 1.9
  2.  
  3. March 6, 1996
  4.  
  5.  
  6.  
  7. Disclaimer and Copyright Notice
  8.  
  9.  
  10. Virtual Desktop is a free utility designed to act as a System 7 virtual
  11. desktop manager.  The author, Ross Brown, makes no warranty, either
  12. express or implied, with respect to this software, its performance,
  13. merchantability, or suitability for any particular purpose.  People using
  14. the Virtual Desktop utility do so at their own risk.  The author disclaims
  15. all liability for loss of data, mechanical damage, or other losses suffered
  16. while using the Virtual Desktop utility.
  17.  
  18. Virtual Desktop is an AWOL Software Production, Copyright ⌐ 1994-6
  19. Ross Brown.  All rights reserved.  Permission is granted to make and
  20. distribute copies of this software, provided this disclaimer and copyright
  21. notice are preserved on all copies.  The software may not, however, be
  22. sold or distributed for profit, or included with other software which is
  23. sold or distributed for profit, without the permission of the author.
  24.  
  25. There are no site license fees for the use of Virtual Desktop within an
  26. organization.  The author encourages you to make and distribute as many
  27. copies of the application as you wish, for whomever you wish, as long as
  28. it is not for profit.  Virtual Desktop is part of a set of cooperating
  29. programs, AWOL Utilities.  The tutorial help you are reading is designed
  30. for handling by the help server application Help on Wheels, which is also
  31. part of AWOL Utilities.
  32.  
  33.  
  34.  
  35. Distribution Policy
  36.  
  37.  
  38. New versions of individual AWOL Utilities programs, including Virtual
  39. Desktop, are available by anonymous FTP from popular archive sites
  40. including sumex-aim.stanford.edu, mac.archive.umich.edu, and their
  41. respective mirror sites, and through Usenet news group
  42. comp.binaries.mac.
  43.  
  44. Support for AWOL Utilities is through Internet mail at address
  45. ab026@freenet.carleton.ca.  The software is not available by FTP from
  46. this site.  The address for paper correspondence is AWOL Software
  47. Productions, PO Box 24207, 300 Eagleson Road, Kanata, Ontario, Canada
  48. K2M 2C3.
  49.  
  50. Macintosh users who do not have access to electronic sources of free and
  51. shareware software may obtain a copy of AWOL Utilities by sending a
  52. self-addressed stamped envelope and an 800K (or larger) formatted
  53. diskette to the author at the above address.  U.S. users are reminded that
  54. postage from Canada in 1996 is C$0.52 up to 30 grams (1 oz.), C$0.77 up
  55. to 50 grams (1 3/4 oz.), and C$1.17 up to 100 grams (3 1/2 oz.).
  56. US$0.50, US$0.75, and US$1.00 in coin is acceptable in place of stamps
  57. for the respective weights.  People outside the U.S. and Canada may send
  58. an international postal reply coupon instead of Canadian stamps (available
  59. from any post office).  Please use sturdy envelopes, preferably cardboard
  60. disk mailers.  (Mailers over 5 mm (1/5") thick require C$1.17 postage to
  61. the U.S.)
  62. Please do not send return envelopes with non-Canadian
  63. stamps, as Canada Post will not accept them.
  64.  
  65.  
  66.  
  67. About AWOL Software Productions
  68.  
  69.  
  70. AWOL Software Productions specializes in custom development of
  71. software for the Mac OS.  Since its inception in 1990, AWOL has
  72. developed a number of programs which enhance the Mac OS user
  73. experience, working in nearly every part of the Macintosh Toolbox.  If
  74. you have a short-term programming task or product idea but lack the
  75. staff to do the expert design, coding, and documentation, we invite your
  76. inquiry.
  77.  
  78. Virtual Desktop is AWOL╒s best-known effort, serving the desktop
  79. expansion needs of thousands of Mac users around the world.  Later in
  80. 1996, AWOL will release a new commercial version 2.0 to replace the
  81. freeware version contained in the AWOL Utilities package.  Please contact
  82. us at ab026@freenet.carleton.ca for feature and ordering information.
  83.  
  84. Users who want more out of the Mac╒s speech capabilities should check
  85. out MacYack Pro, a jointly developed package of speech tools marketed by
  86. Scantron Quality Computers (qualitycomp@aol.com; 20200 Nine Mile Rd.,
  87. St. Clair Shores, MI 48080).
  88.  
  89.  
  90.  
  91. Purpose
  92.  
  93.  
  94. Virtual Desktop is the answer to a growing problem among users of
  95. modern Macintosh computers, who have plenty of RAM to run programs
  96. in, but don╒t have the ╥screen real estate╙ to handle large numbers of
  97. windows productively.  This problem is especially acute for people using
  98. PowerBook computers, because of their small screen size.
  99.  
  100. Virtual Desktop, the premier virtual desktop manager for the Macintosh,
  101. is an adaptation of the kind of virtual window manager found on many X
  102. Window System workstations.  Having allocated some memory for
  103. off-screen buffers, they let the user╒s screen view move between
  104. several ╥rooms╙ where various programs can put their windows.
  105. Usually, these rooms are non-overlapping and arranged in a rigid grid
  106. pattern.  A small-scale window shows the user where all the windows
  107. are, in a stylized form.
  108.  
  109. On the Macintosh, to date, there have been three successful solutions to
  110. this problem.  The first, a commercial program using software
  111. techniques, extended the desktop by scrolling it away when the user
  112. shoved the mouse against the edge of the screen.  The second, a
  113. shareware program with hardware dependencies, bought the user some
  114. extra real estate by opening up the usually black area at the edges of the
  115. monitor.  The third, an increasingly lucrative business, is the sale of
  116. graphic display stations or expansion cards with hardware-based scroll
  117. and zoom capability.
  118.  
  119. Virtual Desktop has a number of advantages over these solutions.  First,
  120. it╒s free.  Second, it works on all types of monitors.  Third, it has a
  121. sophisticated user interface.  Fourth, it takes advantage of System 7
  122. features to do the whole job in the fewest possible clicks and keystrokes.
  123. And last, it╒s free.
  124.  
  125.  
  126.  
  127. Who Can Use Virtual Desktop?
  128.  
  129.  
  130. Any Macintosh running System 7.0 or later can use Virtual Desktop.
  131. There is nothing special to install, but the first time you open Virtual
  132. Desktop, it will ask for permission to install its own system extension,
  133. then suggest that you restart your Macintosh.  This system extension is
  134. required in order for the application to operate.
  135. See the section entitled ╥Virtual Desktop Extension╙ for more
  136. information.
  137.  
  138. NOTE:  To work as it does, the program needs intimate knowledge of how
  139. Finder works.  Because of this dependency, Virtual Desktop checks the
  140. system version at startup, and if it finds itself in an unfamiliar version,
  141. it warns you and lets you decide whether to continue.  This version of
  142. Virtual Desktop may someday be replaced by one which takes account of
  143. changes in later versions of Finder.
  144.  
  145. Virtual Desktop also works on Macintoshes running At Ease instead of
  146. Finder, with the exception of one option which requires Finder.
  147. See the section entitled ╥The Door Preferences Dialog╙ for more
  148. information.
  149.  
  150. Virtual Desktop can be placed on an AppleShare file server, where any
  151. number of users can access it simultaneously.
  152.  
  153.  
  154.  
  155. What Does Virtual Desktop Do?
  156.  
  157.  
  158. Virtual Desktop, simply put, puts scroll bars on your screen.  This is the
  159. most intuitive way for most people to operate a desktop which is larger
  160. than their screen.  This ╥virtual desktop╙ can be as large as the user
  161. wants it to be, with no additional expense of memory.
  162.  
  163. It also has a mode where the user can inspect and rearrange the layout of
  164. windows and icons on the entire virtual desktop.
  165.  
  166. For people who use the same applications every day, Virtual Desktop lets
  167. them build ╥doors,╙ which make the virtual desktop scroll to a preset
  168. location when clicked, in the manner of an old push-button car radio, but
  169. more ergonomic.  You can open a door by clicking, by pressing a
  170. Command-digit combination or F-key, by selection from an optional Door
  171. menu, or (if you have a recent PowerBook or are running System 7.5.2 or
  172. later) by using the Control Strip.
  173.  
  174. Virtual Desktop also has a number of ╥usage options╙ which, when
  175. enabled, let you do quick scrolling actions without leaving the application
  176. you╒re using.
  177.  
  178.  
  179. Scroll Bars
  180.  
  181. Virtual Desktop puts a horizontal scroll bar along the bottom edge of your
  182. main monitor, and a vertical scroll bar along the right or left edge (your
  183. choice).  In the corner between the scroll bars is a little square anchor
  184. window with the Virtual Desktop icon on it, where you can click to make
  185. Virtual Desktop active.
  186.  
  187. While Virtual Desktop is active, you can scroll using either scroll bars or
  188. keyboard.  Press the Page Up or Page Down key to scroll vertically (or
  189. horizontally, with the Option key pressed).  Press the Home key to return
  190. to the ╥home╙ or startup location.  Press the End key to go back to where
  191. you were when you last pressed Home.
  192.  
  193. By default, the scroll bars only appear while Virtual Desktop is active,
  194. but you can have them up all the time, losing a bit of the screen area in
  195. exchange for easier scrolling.  You can also suppress them altogether, if
  196. you prefer.
  197. See the section entitled ╥Usage Options╙ below.
  198.  
  199. Reading the scroll bars╒ ╥sliders╙ tells you where you are on the virtual
  200. desktop in relation to all the other items (windows and desktop icons).
  201. Ordinarily, the extent of the virtual desktop is padded by half a screenful
  202. beyond the most extreme item in each direction.  To grow the desktop,
  203. you can increase that pad factor in increments of half a screenful.  As you
  204. move items farther outward into the pad area, the virtual desktop grows
  205. automatically.
  206.  
  207. The scroll bars appear on the main monitor (the one with the menu bar).
  208. If you change the monitor resolution, move the menu bar to another
  209. monitor, or turn video mirroring on or off, Virtual Desktop adjusts
  210. automatically, moving the scroll bars to the correct position and
  211. positioning the sliders to reflect the new state of your virtual desktop.
  212.  
  213.  
  214. Full View Mode
  215.  
  216. If you need to see beyond what your monitor or monitors can display at
  217. one time, to get the big picture of all items on the virtual desktop, you can
  218. go into Full View mode.  There are three ways to do it ╤ by menu
  219. command, by keystroke, and by double-clicking on the anchor window.
  220.  
  221. Full View mode takes over the main monitor, covering everything but the
  222. menu bar and the scroll bars.  It shows a picture of the whole virtual
  223. desktop, scaled down to fit, with color-keyed rectangles showing the
  224. outline of every application╒s windows, including the ones that are hidden.
  225. A white area in the background shows what part of the virtual desktop is
  226. currently visible through a monitor.  In this picture, you can get help
  227. balloons to tell you what the windows and icons are, click and drag to
  228. rearrange them, and double-click to scroll and bring them to the front so
  229. that you can see them.  You can also drag the white area to move the
  230. desktop view relative to all windows and icons.
  231.  
  232. On one side of the picture, Virtual Desktop shows a set of radio buttons
  233. and a list box.  There is one radio button for every application which has a
  234. window open, plus one at the bottom of the heap for all desktop icons.
  235. When you click on a radio button, Virtual Desktop fills the list box with the
  236. names of all the items belonging to that group.  By selecting an item from
  237. the list, you can see where that item is on the virtual desktop.
  238. Conversely, you can click on an item in the picture to see its name and
  239. what group it belongs to.
  240.  
  241.  
  242. Doors
  243.  
  244. At some point, you will begin to imagine a virtually boundless virtual
  245. desktop layout for your applications ╤ mail windows here, word
  246. processor there, and a picture of your spouse and children in the top
  247. corner, in case you forget what they look like.  It would be hard to move
  248. from location to location using scroll bars, and not very efficient using
  249. Full View mode, so Virtual Desktop gives you a better tool for the job:
  250. doors.
  251.  
  252. To make a door, you scroll to the location you want to work in, and tell
  253. Virtual Desktop to create a new door.  It asks you for a name, and a place
  254. on the desktop where it can drop the little door icon window with the name
  255. on it.  You could build a whole corridor of doors to different places, or use
  256. one of the predefined multiple-door arrangements (row, column, cross, or
  257. grid).  To move from one preset location to another, you just click on a
  258. door.  The door icon ╥opens,╙ and you╒re there.  Every ╥room╙ should
  259. have a trash can alias in the lower right corner, of course, but that╒s
  260. your job.
  261.  
  262. That describes the simplest use of doors.  Beyond that, there are some
  263. useful preference options you can apply to each door.  You can associate
  264. an application with the door, so that Virtual Desktop will make that
  265. application active as you jump to where its windows are.  Better still,
  266. you can have it tell Finder to open any item of your choice (application,
  267. document, folder, or other) when you open the door.  If that application
  268. prefers a specific color depth (╥Thousands╙ of colors, or plain old ╥Black
  269. & White╙), you can tell Virtual Desktop to change the depth when you open
  270. the door.
  271.  
  272. Even when Virtual Desktop isn╒t running, you can use the Door menu,
  273. placed on the right side of the menu bar, to instantaneously launch Virtual
  274. Desktop and open any door.  For PowerBook users and those running
  275. System 7.5.2 or later, the ╥Virtual Desktop Doors╙ Control Strip module
  276. does the same thing without clogging your menu bar.  This feature,
  277. combined with its ability to tie any item to the opening of a door, makes
  278. Virtual Desktop an effective application/document launcher.
  279.  
  280.  
  281. Usage Options
  282.  
  283. This version of Virtual Desktop offers five ways to do virtual desktop
  284. scrolling without leaving the active application.
  285.  
  286. First, you can choose a key combination which scrolls the virtual desktop
  287. up, down, left, or right.  You choose any combination of the modifier keys
  288. (Command, Shift, Option, Control), plus any four keys for the four
  289. directions.
  290.  
  291. Second, you can tell Virtual Desktop to watch the mouse pointer.  If this
  292. option is on, and you move the mouse while pressing any combination of
  293. the modifier keys, the virtual desktop will ╥shift╙ along with the pointer
  294. when you release the keys.
  295.  
  296. Third, you can tell it to react when you shove the mouse pointer into any
  297. edge of the screen, while pressing any combination of the modifier keys.
  298. The virtual desktop will scroll away in the opposite direction.
  299.  
  300. Fourth, you can tell it to show the scroll bars at all times, whatever
  301. application is active.  If you operate a scroll bar while using another
  302. application, Virtual Desktop will return you to that application as soon as
  303. it has scrolled the desktop.
  304.  
  305. Fifth, you can click on a door icon window, or use the Door menu or
  306. Control Strip, to open a door, having set that door to switch back to the
  307. frontmost (active) application.
  308.  
  309.  
  310.  
  311. How Does Virtual Desktop Work?
  312.  
  313.  
  314. Virtual Desktop Extension
  315.  
  316. Virtual Desktop requires a system extension to persuade Finder that the
  317. desktop is larger than your monitors, and to ensure that off-screen icon
  318. positions are recorded correctly.
  319.  
  320. When you open the Virtual Desktop application, it will check to see if the
  321. ╥Virtual Desktop Extension╙ system extension was loaded at startup.  If
  322. not, it will ask for permission to install it in your Extensions folder, if it
  323. isn╒t already there.  If you agree, the application will suggest a restart,
  324. then quit, because the extension must be loaded at startup in order for the
  325. application to operate.
  326.  
  327. If the extension was loaded, but is not the same version as the
  328. application, you will be prompted to replace it.  You must then restart
  329. your Macintosh in order to use the application.
  330.  
  331. If you remove the extension, or disable it by pressing the Shift key at
  332. startup, Finder will bring any desktop icons positioned off-screen back
  333. into view.  (If you do not reposition them, they will return to their
  334. off-screen positions after the next restart.)  This shows how Virtual
  335. Desktop manages the virtual desktop.  It works not by enlarging the
  336. ╥real╙ desktop area using extra memory, but by actually moving
  337. windows and icons around on the desktop.  Part of that trick is to
  338. persuade Finder not to round up the ╥lost sheep.╙
  339.  
  340.  
  341. How to Start Up Virtual Desktop
  342.  
  343. The first time you start up the Virtual Desktop application, you will be
  344. working with a very small virtual desktop, and nothing off the monitors.
  345. If you move some icons off the desktop view using Full View mode, scroll
  346. with the scroll bars, then quit, you will notice that Virtual Desktop has
  347. returned you to the ╥home╙ location, and that the items you moved off
  348. the desktop remain out of view.  You must reopen Virtual Desktop to
  349. access them.  Because the extension implements the illusion of a virtual
  350. desktop, the application need only be open when you want to do some
  351. scrolling.
  352.  
  353. Once you are comfortable with Virtual Desktop, you may want to start it
  354. up by putting it (or an alias to it) in your Startup Items folder.  Another
  355. way is to use door files, Virtual Desktop documents that open the
  356. application and scroll the virtual desktop to a preset location when opened.
  357. You may want to replace some of your current startup items with door
  358. files, having set the preferences for each door so that Finder will open
  359. each item in its own place on the virtual desktop.
  360. See the section entitled ╥The Door Preferences Dialog╙ for more
  361. information about door files.
  362.  
  363. Another way to start up Virtual Desktop is to select a door from the Door
  364. menu or the Control Strip.
  365.  
  366.  
  367. Routine Maintenance
  368.  
  369. Virtual Desktop works by moving windows and icons, not by enlarging the
  370. actual desktop.  Therefore, applications are never aware of where you
  371. are on the virtual desktop.  In a way, this is good, because they will
  372. normally put their windows where you can see them.
  373.  
  374. You will probably want to dedicate an area of the virtual desktop to some
  375. commonly used application.  However, the application doesn╒t know what
  376. that location is, so you have to help it somehow.  One way would be to
  377. move to the location by clicking on a door icon window, then to open the
  378. application using the Apple menu or some desktop icon which you have
  379. placed there for the purpose.  (If you have set the application preferences
  380. for Finder so that Finder╒s windows are exempt from scrolling, you can
  381. always find the icon you want through those windows.)
  382.  
  383. There are several ways to automate the opening of applications and
  384. documents in ╥preferred╙ virtual desktop locations.  One way is to set
  385. the door preferences so that Virtual Desktop asks Finder to open the item
  386. just after scrolling to the door location.  (The only problem with this
  387. approach, depending on the application in question, is that later attempts
  388. to open the door, leading to more requests to open the item, may cause
  389. unwanted effects.)  Another way is to use an alias file converted by
  390. Maybe, another AWOL Utilities program, which automatically tells Virtual
  391. Desktop to scroll to this location just before opening the target item.  Yet
  392. another way is to open the items in question, then start up Virtual
  393. Desktop, which (with the application preferences appropriately set) can
  394. shuttle the windows out to their various door locations.
  395. See the section entitled ╥Suggestions for Use╙ for more information on
  396. Maybe.
  397.  
  398.  
  399. Sensitive Applications
  400.  
  401. The great majority of applications tolerate Virtual Desktop╒s scrolling
  402. behavior with no problems.  There are others, though, and you should be
  403. aware of the symptoms of trouble.
  404.  
  405. First, some applications may not work right if their windows are
  406. off-screen.  This is especially true of well-programmed applications
  407. which use a ╥device loop╙ to compute the right drawing effects for each
  408. monitor their windows intersect, because they typically need to know
  409. which monitor has the greatest color depth, and may get confused if there
  410. isn╒t such a monitor.
  411.  
  412. Second, some applications don╒t use the Macintosh╒s QuickDraw graphics
  413. model to draw on your monitors.  An example would be any
  414. frame-grabbing video expansion card which addresses screen memory
  415. directly.  Their windows will come apart when Virtual Desktop scrolls the
  416. frames without the contents.  Even HyperCard has a little trouble
  417. sometimes.  QuickTime movie players seem to get along fine with Virtual
  418. Desktop, however.
  419.  
  420. Third, some applications don╒t listen to the operating system when it tells
  421. them to redraw parts of their windows which have been exposed by
  422. scrolling, because they think they know which parts are exposed.  These
  423. applications seem to respond better to door jumps than to manual
  424. scrolling.  Applications built with Apple╒s MacApp¿ framework seem
  425. especially prone to this problem.
  426.  
  427. Despite these glitches, though, life with Virtual Desktop is arguably better
  428. than life without.
  429.  
  430.  
  431. How to Shut Down Using Virtual Desktop
  432.  
  433. Virtual Desktop has a Special menu which contains Restart and Shut Down
  434. commands, like those in Finder.  If you use Virtual Desktop regularly, it╒s
  435. good practice to use this Special menu rather than Finder╒s, because it
  436. makes sure that Virtual Desktop gets a chance to clean up and quit before
  437. any other application.
  438.  
  439. If you have a scriptable Finder (version 7.1.4 or later, or version 7.1 or
  440. later with ╥Finder Scripting Extension╙ installed), you may find it helpful
  441. to have the ╥Quit Virtual Desktop╙ application in your Shutdown Items
  442. folder.  This will force Virtual Desktop to quit first when you request a
  443. restart or shutdown by any standard method (Finder╒s Special menu, the
  444. Power key, or the ╥Ñ Shut Down╙ desk accessory).  Note that items in
  445. the Shutdown Items folder may not be opened if you restart or shut down
  446. using any indirect method, such as an installer application.
  447.  
  448. The first time you open Virtual Desktop, just after you agree to install
  449. ╥Virtual Desktop Extension,╙ the application will offer to install ╥Quit
  450. Virtual Desktop╙ in your Shutdown Items folder, if you have a scriptable
  451. Finder.  (You may refuse the offer if you don╒t want ╥Quit Virtual
  452. Desktop╙ installed; if you change your mind later, you can get it using the
  453. Install menu.)
  454.  
  455. If Virtual Desktop doesn╒t clean up before a restart or shutdown, some
  456. applications may record their window positions as off-screen, so the next
  457. time they start up, they may choose a default on-screen position.  This is
  458. quite understandable behavior, actually helpful, except when you are
  459. using Virtual Desktop to manage your desktop.  Virtual Desktop provides
  460. an application preference option to handle this sort by bringing their
  461. windows back into view before they quit.  By practice, you will come to
  462. know which applications need such special treatment.
  463.  
  464.  
  465. Using the Control Strip
  466.  
  467. If you have Apple╒s Control Strip control panel, or one of the
  468. ╥aftermarket╙ shareware programs that let you use Control Strip
  469. modules on any Macintosh, you should consider using the ╥Virtual Desktop
  470. Doors╙ Control Strip module instead of the Door menu.  It gives the same
  471. capability, without taking up space in the menu bar.
  472.  
  473. The first time you open Virtual Desktop, just after you agree to install
  474. ╥Virtual Desktop Extension,╙ the application will offer to install the
  475. Control Strip module in your Control Strip Modules folder, if Control Strip
  476. is available.  (You may refuse the offer if you don╒t want the Control
  477. Strip module installed; if you change your mind later, you can get it using
  478. the Install menu.)  The module will appear in your Control Strip after the
  479. next restart, though you may have to drag the tab at the end of the
  480. Control Strip to make it visible.
  481.  
  482. The menu that pops up from the Control Strip has the same commands as
  483. the Door menu.
  484. See the section entitled ╥The Door Menu╙ for more information.
  485.  
  486. You may find that the Control Strip obscures Virtual Desktop╒s horizontal
  487. scroll bar window.  If you do not intend to use the scroll bars, you can set
  488. a usage option to suppress them.  If you do intend to use them, you can
  489. Option-drag the tab at the end of the Control Strip to move it up from its
  490. usual position at the bottom of the screen.
  491.  
  492.  
  493.  
  494. Suggestions for Use
  495.  
  496.  
  497. Virtual Desktop is distributed as part of a free set of cooperating
  498. programs, AWOL Utilities.  This section explains how Virtual Desktop can
  499. work in conjunction with the other programs.
  500.  
  501.  
  502. Help on Wheels
  503.  
  504. Help on Wheels is an efficient and full-featured help server which displays
  505. help files on behalf of client applications.  The help file you are reading is
  506. distributed alongside the Virtual Desktop application file as a separate
  507. Help on Wheels document.
  508.  
  509. You can read this help at any time while using Virtual Desktop, either by
  510. selecting ╥Virtual Desktop Help╙ from the Help menu, or by pressing the
  511. Help or Command-? key.  Alternatively, press the Help or Command-?
  512. key while the machine is starting up, and release the key once you see the
  513. Virtual Desktop extension icon with a help balloon on it.  The help server
  514. will open to display the help file after startup is complete.  This version
  515. of Virtual Desktop has some support for the sophisticated features of Help
  516. on Wheels, such as context-sensitivity, casual displays, and ╥hot╙
  517. hypertext buttons.
  518.  
  519. This help file can be stored separately from the Virtual Desktop
  520. application, archived, or trashed, without affecting Virtual Desktop╒s
  521. routine operation.
  522.  
  523.  
  524. Maybe
  525.  
  526. Among the options of Maybe, a Finder alias enhancer, is one which lets
  527. you open any other item just as the target item is being opened or printed.
  528. Virtual Desktop has an option to create a very small document called a
  529. door file, whose name matches the name of a door.  Opening a door file
  530. from Finder is another way to open the door.
  531.  
  532. If you have an alias to a document or application which you might like to
  533. work on in a preset location on the virtual desktop, Maybe can convert
  534. that alias, attaching the door file as the item to open first.  Then,
  535. whenever you open the converted alias, whose icon looks like the original,
  536. Maybe and Virtual Desktop co-operate to scroll the virtual desktop to the
  537. ╥right╙ location for that target item, then open it.
  538.  
  539.  
  540. Menu Events
  541.  
  542. Menu Events is a small, single-purpose system extension which lets any
  543. program send Apple events to most high-level-event-aware applications
  544. having a menu bar.  These ╥Menu events╙ let you query the contents and
  545. state of the application╒s menus, then select a menu command and tell the
  546. target application to do it.
  547.  
  548. Virtual Desktop is a useful target for a Menu event, because it has many
  549. menu commands, and no scripting interface.  Any action you can do using
  550. Virtual Desktop menus can be instigated by any application which can send
  551. an Apple event, such as Maybe.
  552.  
  553. NOTE:  Menu Events is intended for Macintosh programmers and those
  554. familiar with Apple event scripting.  If your favorite archive site does not
  555. have Menu Events and its companion application Menu Grabber, you may
  556. request a copy from the author at the addresses listed above.
  557.  
  558.  
  559.  
  560. Windows and Dialogs
  561.  
  562.  
  563. Virtual Desktop operates several windows and dialog boxes, which are
  564. described here.
  565.  
  566.  
  567. The Scroll Bar Windows
  568.  
  569. Virtual Desktop maintains one horizontal and one vertical scroll bar
  570. window.  If you use them while Virtual Desktop is already active, it will
  571. remain active; otherwise, it will return to whatever application was
  572. active before.
  573.  
  574. Through the Layout Preferences dialog, you can vary the thickness of the
  575. scroll bars, and you can move the vertical scroll bar to the left side if
  576. you wish.  A left-handed arrangement is good for southpaws, but also
  577. worth considering just because Finder tends to use the right side of the
  578. desktop for things with no definite position, like volume icons and new
  579. folders and documents.
  580.  
  581. Through the Usage Preferences dialog, you can make the scroll bar
  582. windows appear at all times.  By default, they disappear when Virtual
  583. Desktop goes into the background.  You can also decide not to show the
  584. scroll bars at all, if you prefer other means of scrolling.
  585.  
  586.  
  587. The Anchor Window
  588.  
  589. This small window has the Virtual Desktop icon on it.  Clicking once makes
  590. it active, and clicking twice enters Full View mode.  After that, clicking
  591. toggles between Full View mode and the usual see-through mode.
  592.  
  593.  
  594. The Full View Window
  595.  
  596. This window appears only in Full View mode, covering the area not
  597. occupied by the menu bar and scroll bars.  It consists of three parts:
  598. picture, radio buttons, and list box.
  599.  
  600. Ñ  Picture
  601.  
  602. The picture is the most interesting part of the Full View window.  It offers
  603. many functions.
  604.  
  605. í  Backdrop
  606.  
  607. The Full View picture has a gray backdrop showing the current extent of
  608. the virtual desktop, reduced to fit the area available for the picture
  609. display.  Through the Layout Preferences dialog, you have the option of a
  610. flexible aspect ratio, which distorts images in the picture to fill the
  611. available area, or a true aspect ratio, which scales all images without
  612. distortion, but leaves some unused space in the picture, filled with a
  613. darker gray or black.
  614.  
  615. The virtual desktop is padded in each direction by a factor which you can
  616. adjust using the ╥Grow Desktop╙ and ╥Shrink Desktop╙ menu commands.
  617. If you move a window or icon into the pad area, the virtual desktop will
  618. grow automatically the next time the view is refreshed.
  619.  
  620. í  Desktop View
  621.  
  622. In the background, a white area describes the part of the virtual desktop
  623. which is currently visible through the monitor or monitors, rather like
  624. those ╥through the binoculars╙ shots in bad old movies.  Anything resting
  625. in the white area is the image of a visible window or icon.  You can click
  626. and drag this white area to another point on the virtual desktop, moving
  627. the desktop view relative to all windows and icons.  This is effectively a
  628. diagonal form of scrolling.  If you use the scroll bars, you will see the
  629. white area move accordingly.
  630.  
  631. í  Window and Icon Images
  632.  
  633. Every window or desktop icon (collectively known as ╥items╙) appears in
  634. the picture as an outline rectangle with a representative size, shape, and
  635. position.  On a color monitor, the color of the rectangle matches that of
  636. the owning application╒s radio button, for easy recognition.
  637.  
  638. Where images overlap, the outline of the front item is solid, and the
  639. others are hatched (cut diagonally).  On a color monitor, the cursor
  640. changes color as it passes over the images, to help you see which window
  641. is in front at that point.  With balloons showing, you can get detailed
  642. information on what the mouse is pointing to.
  643.  
  644. The images of windows belonging to hidden applications, as well as
  645. windows rolled up using WindowShade, appear as thin dotted outlines.
  646. They don╒t figure in the cursor or balloon behavior described above unless
  647. the Option key is pressed.
  648.  
  649. The mechanism for selecting and dragging item images is a little unusual.
  650. At any time, there may be only one item selected.  Its image outline is
  651. filled in.  Even if that item is behind other items at some points, the
  652. hand-shaped cursor tells you that you can click and drag that item from
  653. any point to any other point, without making it active.  By contrast, you
  654. can also click and drag a non-selected item, without affecting the
  655. selection, but the item dragged will be the one which is frontmost at the
  656. click point.
  657.  
  658. An item becomes selected either by clicking on its image, or by actions on
  659. the radio buttons or list box.  The current selection is always reflected in
  660. all three parts of the Full View window ╤ picture, radio buttons, and list
  661. box.
  662.  
  663. If you double-click on an item image, Virtual Desktop will make that
  664. window or icon active (showing the window if it was hidden or rolled up
  665. using WindowShade), and go into the background.  If the point where you
  666. clicked was outside the white area, the desktop view will scroll
  667. automatically to center the selected item on the main monitor.  Likewise,
  668. you can press the Return or Enter key to make the selected item active,
  669. but scrolling will only occur if the item is completely outside the desktop
  670. view.
  671.  
  672. The entire Full View window is a static display.  It does not track the
  673. movements, appearances, or disappearances of windows and icons.  If
  674. Virtual Desktop finds that an item has moved, disappeared, or changed its
  675. title, the cursor shows a question mark while over the item╒s image, and
  676. you cannot do anything with the item.  The ╥Refresh╙ menu command
  677. clears up this situation, redrawing the entire window and repositioning
  678. the scroll bars.
  679.  
  680. NOTE:  The virtual desktop may sometimes become very large, and the
  681. images very small, because some application has placed a window in a
  682. very remote position.  This is a technique some programmers use to hide
  683. a window.  If this becomes a problem, move the window╒s image nearer to
  684. the rest of the items, then use the ╥Refresh╙ menu command to rescale
  685. the picture.
  686.  
  687. Ñ  Radio Buttons
  688.  
  689. The order of radio buttons from top to bottom is the same as the layering
  690. order of the applications╒ windows.  However, applications without
  691. windows do not appear.  A special button labeled ╥Desktop icons╙ at the
  692. bottom covers all desktop icons.
  693.  
  694. Each radio button is given a color to match the images in the picture.  By
  695. default, the color is computed by hashing the application╒s signature, but
  696. you can change it through the Application Preferences dialog.
  697.  
  698. Clicking on a radio button fills the list box with the titles of the
  699. application╒s windows (or desktop icons) and selects the front item in the
  700. list and in the picture.  You can use Shift-Up-Arrow and
  701. Shift-Down-Arrow to go up and down the stack of radio buttons without
  702. using the mouse.
  703.  
  704. When you are selecting items using images in the picture, the radio button
  705. selection changes accordingly.
  706.  
  707. Ñ  List Box
  708.  
  709. The order of entries from top to bottom is the same as the layering order
  710. of the selected application╒s windows (or desktop icons).
  711.  
  712. Items without titles appear in the list as ╥[untitled]╙.  If an item moves,
  713. disappears, or changes title, its entry in the list changes to ╥[moved]╙,
  714. ╥[defunct]╙, or ╥[retitled]╙.
  715.  
  716. You can use Up Arrow and Down Arrow to go up and down the list without
  717. using the mouse.  You can also select by typing the first few letters of an
  718. item╒s title.
  719.  
  720. If you double-click on a list entry, Virtual Desktop will make that window
  721. or icon active (showing the window if it was hidden or rolled up using
  722. WindowShade), and go into the background.  If the item is completely
  723. outside the desktop view, the desktop view will scroll automatically to
  724. center the selected item on the main monitor.
  725.  
  726. When you are selecting items using images in the picture, the list
  727. selection changes accordingly.
  728.  
  729.  
  730. The Door Icon Windows
  731.  
  732. Every door you define can have a small iconic window on the desktop,
  733. which does not move when the virtual desktop scrolls.  Each door icon
  734. window carries the first few letters of the door╒s name for identification,
  735. and can have its own distinctive door and wall colors.
  736.  
  737. When you create a door, unless the default door preference option is not
  738. to show door icon windows, Virtual Desktop prompts you to place the
  739. window with a special door-shaped cursor.  After you have placed the
  740. window, you can move it by clicking and dragging.  A good practice is to
  741. reserve a small area in one corner of the main monitor, where door icon
  742. windows can congregate and be visible regardless of which door is open.
  743.  
  744. Clicking once on the door icon window (without dragging) opens the door.
  745. If you press the Option key while clicking, Virtual Desktop will ignore any
  746. option to switch applications or change the color depth after opening the
  747. door, and will remain active.
  748.  
  749.  
  750. The About Dialog
  751.  
  752. This dialog presents Virtual Desktop╒s About box.  It is opened by the
  753. ╥About Virtual Desktop╔╙ command in the Apple menu.
  754.  
  755. It mentions, by way of a balloon, that Virtual Desktop offers help through
  756. both Balloon Help and Help on Wheels.  If you already have balloons
  757. showing, Virtual Desktop spares you the balloon, figuring that you╒ve
  758. probably seen enough recently.
  759.  
  760.  
  761. The Layout Preferences Dialog
  762.  
  763. This dialog appears when you select Layout╔ from the Preferences menu.
  764. It lets you set options which affect the appearance of Virtual Desktop
  765. windows.
  766.  
  767. Ñ  Orientation option
  768.  
  769. Choose a left- or right-handed orientation of Virtual Desktop windows
  770. using the radio buttons.  A left-handed orientation places the vertical
  771. scroll bar at the left edge of the main monitor, and places the list box and
  772. radio buttons at the left side of the Full View window.
  773.  
  774. The default is a right-handed orientation.
  775.  
  776. Ñ  Scroll Bar Thickness option
  777.  
  778. Depending on how much screen area you have to spare, and how accurate
  779. you can be with your clicks, you may want to increase or decrease the
  780. width of the scroll bars.  (If they are taking up too much space, you may
  781. want to suppress them altogether using the Usage Preferences dialog.)
  782. Allowable values are between 4 and 64 pixels, inclusive.
  783.  
  784. The default is for standard 16-pixel-wide scroll bars.
  785.  
  786. Ñ  Full View Sidebar Width option
  787.  
  788. If you have a large main monitor, you may want to give the Full View list
  789. box and radio buttons more width in which to display item titles and
  790. application names.  Allowable values are between 64 and 256 pixels,
  791. inclusive.
  792.  
  793. The default is for a 128-pixel-wide sidebar.
  794.  
  795. Ñ  Full View Desktop Aspect Ratio option
  796.  
  797. Choose a flexible or true aspect ratio for the Full View picture using the
  798. radio buttons.  A flexible aspect ratio distorts item images to maximize
  799. coverage in the picture, while a true aspect ratio preserves the shape of
  800. images and leaves dark gray or black gutters beside the virtual desktop
  801. backdrop.
  802.  
  803. The default is to use a flexible desktop aspect ratio.
  804.  
  805. Ñ  Cancel
  806.  
  807. Click here to cancel the changes made to existing layout options.
  808.  
  809. Ñ  Use Defaults
  810.  
  811. Click here to change all options to their default values, the ones described
  812. in this help file.
  813.  
  814. Ñ  OK
  815.  
  816. Click here to accept the options and close the dialog.  This will
  817. immediately change the Virtual Desktop window display.
  818.  
  819. If any options are invalid, you are prompted to correct them.
  820.  
  821.  
  822. The Usage Preferences Dialog
  823.  
  824. This dialog appears when you select Usage╔ from the Preferences menu.
  825. It lets you set options which affect how you can ask Virtual Desktop to
  826. scroll the virtual desktop while it is in the background.
  827.  
  828. These options are not effective unless the Virtual Desktop application is
  829. running.  However, using the Door menu does start up the application.
  830.  
  831. Ñ  Press Key option
  832.  
  833. If this option is in effect, Virtual Desktop will react to certain
  834. keystrokes, even if it is in the background.  Use the individual check
  835. buttons to select one or more modifier keys (Command, Shift, Option,
  836. Control) which must be down when the key is pressed.  Click on one of the
  837. four arms of the compass rose to change the key which causes Virtual
  838. Desktop to scroll in that direction.  (In this respect, keys on the numeric
  839. keypad are distinct from the like-labeled keys on the main part of the
  840. keyboard.)
  841.  
  842. NOTE:  The active application will not see the keystroke if this option has
  843. been set to react to it.  If your key combination choices are obstructing
  844. your use of some application, press the Caps Lock key, and try again.
  845. This will cause Virtual Desktop to ignore the keystroke.
  846.  
  847. This option is separate from the built-in support for the Home, End, Page
  848. Up, and Page Down keys, which work only while the Virtual Desktop
  849. application is active.
  850.  
  851. This option usually works even if you are facing a modal dialog, the kind
  852. which you must answer before you can do anything else.  Sometimes you
  853. may need it to get a look at a modal dialog box which has come up outside
  854. the visible desktop area.
  855.  
  856. The default is a Shift-Control-Arrow combination for all four directions,
  857. but the entire option is off by default.
  858.  
  859. Ñ  Move Mouse option
  860.  
  861. If this option is in effect, Virtual Desktop will track the mouse pointer
  862. whenever the selected modifier keys are pressed, and scroll the virtual
  863. desktop in the direction of mouse movement.  It is as if you have put your
  864. finger on the desktop ╥blotter╙ holding all of the windows and icons, and
  865. pushed it across the desk.
  866.  
  867. A blinking circle on the desktop marks the point where the pointer was
  868. when the modifier keys were pressed.  This marker does not appear until
  869. you have moved the pointer a certain distance, and disappears again if you
  870. move it back.  So, if you didn╒t mean to shift the desktop, and you see a
  871. blinking circle, you should extinguish it before releasing any of the
  872. modifier keys (or pressing another).
  873.  
  874. When you release any of the modifier keys (or press another), if the
  875. pointer has moved significantly, Virtual Desktop will shift the desktop
  876. accordingly.  Whatever was under the blinking circle moves to the new
  877. mouse position, and everything else with it.
  878.  
  879. Like the Press Key option, this option usually works even if a modal dialog
  880. is posted.
  881.  
  882. In previous versions, this option worked only with the Shift key, and that
  883. remains the default, though it is not the most practical choice, given that
  884. many applications support Shift-selection and Shift-dragging.
  885.  
  886. The default modifier key is Shift, but the entire option is off by default.
  887.  
  888. Ñ  Shove Mouse option
  889.  
  890. If this option is in effect, Virtual Desktop will react to the mouse pointer
  891. hitting any edge of the screen whenever the selected modifier keys are
  892. pressed, and scroll the virtual desktop away from that edge.  This is
  893. handy when you need access to something which is just off the visible
  894. desktop in that direction.
  895.  
  896. The desktop will continue to scroll as long as you hold the mouse pointer
  897. at the edge and press the selected modifier keys, so you can regulate this
  898. form of scrolling by twitching the mouse or by pressing and releasing the
  899. modifier keys.  (The repeat rate is based on the double-click speed which
  900. you select using the Mouse control panel.)
  901.  
  902. Like the Press Key and Move Mouse options, this option usually works
  903. even if a modal dialog is posted.
  904.  
  905. Be careful if you assign the Option key as the modifier key for this option,
  906. as it may cause unwanted scrolling when selecting from the menu bar.
  907.  
  908. The default modifier keys are Option and Control, but the entire option is
  909. off by default.
  910.  
  911. Ñ  Scroll Bars option
  912.  
  913. If this option is in effect, Virtual Desktop will show scroll bar windows at
  914. the sides of the main monitor.
  915.  
  916. If you select ╥always,╙ Virtual Desktop will not hide its scroll bar
  917. windows when going into the background, so that they continue to be
  918. available at all times.  Virtual Desktop will become active while the user
  919. operates the scroll bars, but will return to the background afterwards.
  920.  
  921. If you select ╥only when active,╙ Virtual Desktop will hide its scroll bar
  922. windows when going into the background.
  923.  
  924. This option does not work when a modal dialog is posted, because you can
  925. only use the mouse within the dialog box.
  926.  
  927. This option is on by default, with scroll bar windows showing only when
  928. Virtual Desktop is active.
  929.  
  930. Ñ  Door Menu option
  931.  
  932. If this option is in effect when the machine is starting up, the Virtual
  933. Desktop extension will place the Door menu in the menu bar alongside the
  934. Help, Keyboard, and Application menus.  A change to this option will take
  935. effect at the next restart.
  936. See the section entitled ╥The Door Menu╙ for more information.
  937.  
  938. This option is on by default.
  939.  
  940. Ñ  Scroll by option
  941.  
  942. If you select ╥half screens,╙ Virtual Desktop will scroll the virtual
  943. desktop by half a screenful when you use the ╥press key,╙ ╥shove
  944. mouse,╙ or ╥scroll bars╙ usage option, or when you press the Page Up or
  945. Page Down key.
  946.  
  947. If you select ╥full screens,╙ Virtual Desktop will scroll by a screenful
  948. instead.  This may not be apparent when using the scroll bars, because the
  949. default virtual desktop padding is only half a screenful, and you cannot
  950. scroll farther outward until you grow the virtual desktop.
  951.  
  952. The default is to scroll by half screens.
  953.  
  954. Ñ  Cancel
  955.  
  956. Click here to cancel the changes made to existing usage options.
  957.  
  958. Ñ  Use Defaults
  959.  
  960. Click here to change all options to their default values, the ones described
  961. in this help file.
  962.  
  963. Ñ  OK
  964.  
  965. Click here to accept the options and close the dialog.
  966.  
  967. If any options are invalid, you are prompted to correct them.
  968.  
  969.  
  970. The Application Preferences Dialog
  971.  
  972. This dialog appears when you select Application╔ from the Preferences
  973. menu.  It lets you set options which affect the handling of the current
  974. application╒s windows (or desktop icons).  The current application is the
  975. one whose radio button is selected in the Full View window.  This dialog is
  976. not available outside of Full View mode.
  977.  
  978. Ñ  Color option
  979.  
  980. Click on the colored square to change the color used for the current
  981. application╒s radio button and for all of its item images in the picture.
  982.  
  983. The default is a color computed by hashing the application╒s signature.
  984.  
  985. Ñ  Exempt Application╒s Items From All Scrolling option
  986.  
  987. If this option is in effect, Virtual Desktop will not move the current
  988. application╒s windows (or desktop icons) when it scrolls the virtual
  989. desktop.  They retain their position in the desktop view, that is, they
  990. stick to the monitor(s).  This option is appropriate for utilities which
  991. provide menu-bar-like functions, and for monitor programs like
  992. PrintMonitor.
  993.  
  994. This option is off by default.
  995.  
  996. Ñ  Anchor Application╒s Items to Door option
  997.  
  998. This option is not available if the Exempt Application╒s Items From All
  999. Scrolling option is on.  It is also not applicable to desktop icons.
  1000.  
  1001. If the current application╒s windows are usually confined to the home
  1002. area, you should choose ╥none╙ from the pop-up menu, meaning that
  1003. Virtual Desktop will leave the windows where they are on the virtual
  1004. desktop when quitting.  If they happen to be outside the home area, they
  1005. may be inaccessible until you open Virtual Desktop again.
  1006.  
  1007. If the current application is usually associated with one door location, you
  1008. should choose that door from the pop-up menu.  When Virtual Desktop
  1009. quits, it will move the current application╒s windows into the home area,
  1010. in the same positions which they occupied relative to that door.  When
  1011. Virtual Desktop opens the next time, it will move the windows back to
  1012. that door area.  This capability is important if you don╒t intend to keep
  1013. Virtual Desktop open all the time, because it lets you use doors to
  1014. separate the windows of several applications, but then to see all of the
  1015. windows stacked up in the home area when you quit Virtual Desktop.  Even
  1016. if you do keep Virtual Desktop open all the time, this option is necessary
  1017. for applications which remember the positions of their windows when
  1018. they quit.  If the application╒s windows are off-screen when you restart
  1019. or shut down your Macintosh, it may decide to ignore those positions the
  1020. next time you open it, instead choosing default positions, probably not
  1021. what you want.  By using this option, and by making it a habit to restart
  1022. or shut down using Virtual Desktop╒s Special menu rather than Finder╒s
  1023. (or, if you have a scriptable Finder, by placing the ╥Quit Virtual Desktop╙
  1024. application in your Shutdown Items folder), so that Virtual Desktop gets to
  1025. quit first, you are assured that such applications will remember
  1026. meaningful, on-screen window positions for the next session.
  1027.  
  1028. NOTE:  If you later rename the door, you should update this option,
  1029. because the door you choose is recorded by name.
  1030.  
  1031. The default is not to anchor the application╒s windows to any door.
  1032.  
  1033. Ñ  Cancel
  1034.  
  1035. Click here to cancel the changes made to existing application options.
  1036.  
  1037. Ñ  Use Defaults
  1038.  
  1039. Click here to change all options to their default values, which you may
  1040. have changed using Make Defaults (see below).  Click here with the Option
  1041. key pressed to change all options to their built-in default values, the ones
  1042. described in this help file.
  1043.  
  1044. Ñ  Make Defaults
  1045.  
  1046. Click here to change the default values for all options (except the Color
  1047. option) to those displayed in the dialog.
  1048.  
  1049. Ñ  OK
  1050.  
  1051. Click here to accept the options and close the dialog.
  1052.  
  1053.  
  1054. The Door Preferences Dialog
  1055.  
  1056. When you create a new door, its initial options are the defaults.  Its
  1057. location on the virtual desktop is the current location of the desktop view.
  1058. You can use the Door Preferences dialog to change the location or other
  1059. options later on.  To change the name of the door, you must select
  1060. ╥Rename Door╔╙ from the Actions menu.
  1061.  
  1062. To change its options, the door must be open, and Virtual Desktop must be
  1063. active.  If the door options cause Virtual Desktop to go into the background
  1064. after opening the door, you must either press the Option key while opening
  1065. the door using its menu command, keyboard equivalent, or door icon
  1066. window, or bring Virtual Desktop back to the front after opening the door.
  1067.  
  1068. Ñ  View Offset option
  1069.  
  1070. These numbers indicate many pixels the door location is away from the
  1071. home location, horizontally and vertically.  (Positive numbers indicate a
  1072. door location above or to the left of the home location.)
  1073.  
  1074. If you change these numbers, the virtual desktop will scroll according to
  1075. the new offsets.  This allows you to fine-tune door locations.
  1076.  
  1077. Ñ  Graphical Presence options
  1078.  
  1079. These options control how the door appears on the desktop, as a door icon
  1080. window, or as a door file with a Finder icon.  Both alternatives give you a
  1081. way of opening the door quickly from outside Virtual Desktop.
  1082.  
  1083. í  Show Window option
  1084.  
  1085. When this option is in effect, a door icon window appears on the desktop.
  1086. This small window does not move when the virtual desktop scrolls.
  1087. Clicking once in the window opens the door.  You may decide not to have a
  1088. door icon window for every door you define, especially if you are using
  1089. the Door menu or Control Strip to open doors.
  1090.  
  1091. This option is on by default.
  1092.  
  1093. í  Door and Wall color options
  1094.  
  1095. Click on the top or bottom half of the colored square to change the color
  1096. used to draw the ╥door face╙ or background ╥wall╙ in the door icon
  1097. window.  You can use color to distinguish between your various doors.  If
  1098. the door color is dark, Virtual Desktop will draw the door name in white
  1099. instead of black.
  1100.  
  1101. The default is a drab brown and gray color scheme.
  1102.  
  1103. í  Create File╔ option
  1104.  
  1105. Click here to create a door file, a small document belonging to Virtual
  1106. Desktop which gives you a way to open a door through Finder.  The file
  1107. dialog which appears asks you not to make the name of the door file
  1108. different from the name of the door.  This is because the name is the only
  1109. important information in the door file.
  1110.  
  1111. You can place door files on the desktop, as an alternative to door icon
  1112. windows, or in your Startup Items folder, or in a special Doors folder
  1113. inside your Preferences folder, where they can be attached to document
  1114. or application aliases by the Maybe utility.
  1115. See the section entitled ╥Suggestions for Use╙ for more information on
  1116. this approach.
  1117.  
  1118. NOTE:  If you later rename the door, you should rename these files as
  1119. well.
  1120.  
  1121. Ñ  Keyboard Binding option
  1122.  
  1123. If you don╒t have a macro utility which lets you open a door file by
  1124. pressing a combination of keys, another way to speed up your use of
  1125. doors is to have keyboard bindings for them.  These bindings are valid
  1126. only when Virtual Desktop is active.  You can bind any F-key or
  1127. Command-digit combination to any door.
  1128.  
  1129. As with menu commands and door icon windows, if the Option key is
  1130. pressed when you use the keyboard binding to open a door, Virtual Desktop
  1131. will ignore the Switch to and Depth options, and remain active.
  1132.  
  1133. The default is not to have a keyboard binding.
  1134.  
  1135. Ñ  Switch to option
  1136.  
  1137. This pop-up menu lists all applications to which Virtual Desktop can switch
  1138. as the door is opened.  You may want to choose an application whose
  1139. windows are prevalent in the desktop view when the virtual desktop
  1140. scrolls to the door location.
  1141.  
  1142. NOTE:  If you later rename the application, or replace it with a new
  1143. version whose name is different, you should update this option, because
  1144. the application you choose is recorded by name.
  1145.  
  1146. You have three other choices, ╥frontmost application╙, ╥stay in Virtual
  1147. Desktop,╙ and ╥item via Finder╔╙  If you select ╥frontmost
  1148. application,╙ Virtual Desktop will return to the background after opening
  1149. the door, allowing the application which was active before it to return to
  1150. the front.  This makes opening a door similar to clicking on a Virtual
  1151. Desktop scroll bar while using another application.  If you select ╥item via
  1152. Finder╔,╙ you must then choose the item (application, document, folder,
  1153. volume, alias, or whatever) you want Finder to open whenever you open
  1154. this door.  Because this choice is recorded using alias information, it is
  1155. unaffected by renaming of files and folders, and you can take advantage of
  1156. alias features such as automatic volume remounting and Apple Remote
  1157. Access dial-up reconnection.
  1158.  
  1159. The default is to stay in Virtual Desktop.
  1160.  
  1161. Ñ  Depth option
  1162.  
  1163. This pop-up menu lists the color depths to which Virtual Desktop can
  1164. switch as the door is opened.  You may want to choose a depth which suits
  1165. the application whose windows are prevalent in the desktop view when the
  1166. virtual desktop scrolls to the door location.
  1167.  
  1168. Virtual Desktop does not know what color depths your monitors can
  1169. support, so it offers choices which may not apply to some or all of your
  1170. monitors.  If you choose a depth, Virtual Desktop will try to switch all
  1171. monitors to that depth when the door is opened.  This will not affect any
  1172. monitor which does not support that depth.
  1173.  
  1174. If you select ╥as is,╙ Virtual Desktop will not attempt to change the color
  1175. depth of any monitor.
  1176.  
  1177. The default is not to change the color depth.
  1178.  
  1179. Ñ  Cancel
  1180.  
  1181. Click here to cancel the changes made to existing door options.
  1182.  
  1183. Ñ  Use Defaults
  1184.  
  1185. Click here to change all options to their default values, which you may
  1186. have changed using Make Defaults (see below).  Click here with the Option
  1187. key pressed to change all options to their built-in default values, the ones
  1188. described in this help file.
  1189.  
  1190. Ñ  Make Defaults
  1191.  
  1192. Click here to change the default values for all options (except the View
  1193. Offset option) to those displayed in the dialog.
  1194.  
  1195. Ñ  OK
  1196.  
  1197. Click here to accept the options and close the dialog.
  1198.  
  1199.  
  1200.  
  1201. Menus
  1202.  
  1203.  
  1204. This section describes each of Virtual Desktop╒s menus.
  1205.  
  1206.  
  1207. The Apple Menu
  1208.  
  1209. Ñ  About Virtual Desktop╔
  1210.  
  1211. This command opens Virtual Desktop╒s About dialog, which invites you to
  1212. try Balloon Help or Help on Wheels to learn more about Virtual Desktop.
  1213.  
  1214.  
  1215. The File Menu
  1216.  
  1217. Ñ  Close (Command-W)
  1218.  
  1219. This command is only a place-holder, and is never available, because
  1220. Virtual Desktop does not keep documents open.  The only documents
  1221. Virtual Desktop has are door files, which are only references to doors to
  1222. be opened.
  1223.  
  1224. Ñ  Quit (Command-Q)
  1225.  
  1226. This command quits Virtual Desktop.  This will return the desktop view to
  1227. the home location, and if any applications have their windows anchored to
  1228. a door, those windows will fall back into the desktop view.  Any other
  1229. windows and desktop icons which were outside the home location will
  1230. remain off-screen.
  1231.  
  1232.  
  1233. The Edit Menu
  1234.  
  1235. Ñ  Undo (Command-Z)
  1236.  
  1237. This command is not used by Virtual Desktop.  It is present only for desk
  1238. accessories.
  1239.  
  1240. Ñ  Cut (Command-X)
  1241.  
  1242. This command cuts selected text to the clipboard.  It is used only with
  1243. desk accessories and dialogs containing text fields.
  1244.  
  1245. Ñ  Copy (Command-C)
  1246.  
  1247. This command copies selected text to the clipboard.  It is used only with
  1248. desk accessories and dialogs containing text fields.
  1249.  
  1250. Ñ  Paste (Command-V)
  1251.  
  1252. This command inserts the contents of the clipboard at the current cursor
  1253. location or replaces the currently selected text by the contents of the
  1254. clipboard.  It is used only with desk accessories and dialogs containing
  1255. text fields.
  1256.  
  1257. Ñ  Clear
  1258.  
  1259. This command clears the selected text in a desk accessory or dialogs
  1260. containing text fields.
  1261.  
  1262.  
  1263. The Actions Menu
  1264.  
  1265. Ñ  Full View (Command-F)
  1266.  
  1267. This command toggles between Full View mode and the usual see-through
  1268. mode.  The check mark indicates the current mode.
  1269.  
  1270. Ñ  Refresh (Command-R)
  1271.  
  1272. This command re-examines the complete set of windows and icons now on
  1273. the virtual desktop, recomputes scroll bar positions and the extent of the
  1274. virtual desktop, and redraws all windows accordingly.
  1275.  
  1276. Ñ  Grow Desktop (Command-Plus)
  1277.  
  1278. This command adds half a screenful to the padding at all four sides of the
  1279. virtual desktop, giving you more room to reposition your windows and
  1280. icons.  The maximum width or height of the virtual desktop, including
  1281. padding, is 32,767 pixels.  Therefore, the padding cannot exceed 32,767
  1282. pixels in either direction.  If the padding is already at its maximum, this
  1283. command is disabled.
  1284.  
  1285. Ñ  Shrink Desktop (Command-Minus)
  1286.  
  1287. This command subtracts half a screenful from the padding at all four sides
  1288. of the virtual desktop.  In Full View mode, if images seem to be too small,
  1289. you should try shrinking the desktop.  If the padding is already at its
  1290. minimum, this command is disabled.
  1291.  
  1292. Ñ  New Door╔ (Command-N)
  1293.  
  1294. This command prompts you for the name of a new door, which must not
  1295. match any existing door name.  The door is created with preference
  1296. options set so as to jump to the current virtual desktop location when
  1297. opened.  If the preferences file is unwritable, this command is disabled.
  1298.  
  1299. The default is create a single door, but by using the pop-up menu, you can
  1300. create 3, 5, or 9 doors at once.  The door at the center of these
  1301. multiple-door arrangements will lead to the current virtual desktop
  1302. location, and the others will lead to nearby locations as indicated by the
  1303. pattern.
  1304.  
  1305. If the default door preference options allow door windows to show,
  1306. Virtual Desktop will prompt you to place the door window with a special
  1307. door-shaped cursor.  In a multiple-door arrangement, the other door icon
  1308. windows are placed automatically according to the pattern.
  1309.  
  1310. Ñ  Rename Door╔
  1311.  
  1312. This command prompts you to give the currently open door a new name,
  1313. which must not match any other existing door name.  If no door is open, or
  1314. the preferences file is unwritable, this command is disabled.
  1315.  
  1316. NOTE:  When you rename a door, you should update the application
  1317. preferences of any application whose items are anchored to that door.
  1318. You should also change the name of any door files you had created.
  1319.  
  1320. Ñ  Trash Door╔ (Command-T) or Trash Door (Command-Option-T)
  1321.  
  1322. This command trashes the currently open door.  An alert box appears to
  1323. ask for confirmation.  If no door is open, or the preferences file is
  1324. unwritable, this command is disabled.
  1325.  
  1326. With the Option key pressed, before you click in the menu bar, the
  1327. confirmation alert is suppressed.
  1328.  
  1329. Ñ  Home (Command-H)
  1330.  
  1331. This command returns the desktop view to the home location, where it
  1332. was when Virtual Desktop started up.
  1333.  
  1334. Ñ  Door ╥Name╙ (various)
  1335.  
  1336. There is one command in this menu for each defined door.  If the door has
  1337. a Command-digit binding, it appears in the menu.  Function-key bindings do
  1338. not appear in the menu.
  1339.  
  1340. Selecting a door command causes Virtual Desktop to open the door, just as
  1341. if the user had clicked on the door window.  Press the Option key while
  1342. selecting a door command to keep Virtual Desktop active, ignoring the
  1343. door preference options to activate a certain application or change the
  1344. color depth.
  1345.  
  1346.  
  1347. The Preferences Menu
  1348.  
  1349. Ñ  Layout╔ (Command-L)
  1350.  
  1351. This command opens the Layout Preferences dialog.
  1352. See the section entitled ╥The Layout Preferences Dialog╙ for more
  1353. information.
  1354.  
  1355. Ñ  Usage╔ (Command-U)
  1356.  
  1357. This command opens the Usage Preferences dialog.
  1358. See the section entitled ╥The Usage Preferences Dialog╙ for more
  1359. information.
  1360.  
  1361. Ñ  Application╔ (Command-A)
  1362.  
  1363. This command opens the Application Preferences dialog.  It is available
  1364. only in Full View mode, and applies to the current application, as shown by
  1365. the radio buttons.
  1366. See the section entitled ╥The Application Preferences Dialog╙ for more
  1367. information.
  1368.  
  1369. Ñ  Item╔ (Command-I)
  1370.  
  1371. This command is not implemented in this version of Virtual Desktop.
  1372.  
  1373. Ñ  Door╔ (Command-D)
  1374.  
  1375. This command opens the Door Preferences dialog.  It is available only if a
  1376. door is currently open.
  1377. See the section entitled ╥The Door Preferences Dialog╙ for more
  1378. information.
  1379.  
  1380.  
  1381. The Special Menu
  1382.  
  1383. Ñ  Restart
  1384.  
  1385. This command is exactly equivalent to Finder╒s Restart command, but
  1386. gives Virtual Desktop the chance to take action on the Anchor
  1387. Application╒s Items to Door option by quitting before any other application
  1388. can quit.
  1389.  
  1390. Ñ  Shut Down
  1391.  
  1392. This command is exactly equivalent to Finder╒s Shut Down command, but
  1393. gives Virtual Desktop the chance to take action on the Anchor
  1394. Application╒s Items to Door option by quitting before any other application
  1395. can quit.
  1396.  
  1397.  
  1398. The Install Menu
  1399.  
  1400. Ñ  ╥Virtual Desktop Extension╙ ╤> Extensions
  1401.  
  1402. This command installs an up-to-date version of ╥Virtual Desktop
  1403. Extension╙ in your Extensions folder, replacing any version already
  1404. there.
  1405. See the section entitled ╥Virtual Desktop Extension╙ for more information
  1406. on what this extension does.
  1407.  
  1408. Ñ  ╥Virtual Desktop Doors╙ ╤> Control Strip Modules
  1409.  
  1410. This command installs an up-to-date version of ╥Virtual Desktop Doors╙
  1411. in your Control Strip Modules folder, replacing any version already there.
  1412. If the Control Strip is not installed on your Macintosh, this command is
  1413. disabled.
  1414. See the section entitled ╥Virtual Desktop Doors╙ for more information on
  1415. what this Control Strip module does.
  1416.  
  1417. Ñ  ╥Quit Virtual Desktop╙ ╤> Shutdown Items
  1418.  
  1419. This command installs an up-to-date version of ╥Quit Virtual Desktop╙ in
  1420. your Shutdown Items folder, replacing any version already there.  If you
  1421. have a non-scriptable Finder which does not support a Shutdown Items
  1422. folder, this command is disabled.
  1423. See the section entitled ╥Quit Virtual Desktop╙ for more information on
  1424. what this miniature application does.
  1425.  
  1426.  
  1427. The Help Menu
  1428.  
  1429. Ñ  About Balloon Help╔
  1430.  
  1431. This command, supplied by System software, tells you how to use Balloon
  1432. Help.  Virtual Desktop supports Balloon Help.
  1433.  
  1434. Ñ  Show/Hide Balloons
  1435.  
  1436. This command, supplied by System software, lets you turn Balloon Help
  1437. on and off.  Virtual Desktop supports Balloon Help.
  1438.  
  1439. Ñ  Virtual Desktop Help
  1440.  
  1441. This command asks Help on Wheels to display Virtual Desktop╒s help file.
  1442. This will start the help server if it was not already running.  If the help
  1443. server cannot be found on any mounted volume, Virtual Desktop will offer
  1444. to save a readable copy of the help file as a TeachText file, then ask
  1445. Finder to open the file.  If the help file is missing or invalid, this command
  1446. is disabled.
  1447.  
  1448. Pressing the Help or Command-? key at any time does the same thing.
  1449. When there is a dialog box on your screen, such as the options dialog, the
  1450. menu command is disabled, and the keyboard is the only way to display
  1451. help.
  1452.  
  1453.  
  1454. The Door Menu
  1455.  
  1456. This menu appears alongside the Help, Keyboard, and Application menus at
  1457. the right side of the menu bar, whatever application is active.  It appears
  1458. only if the Door Menu option was selected in the Usage Preferences dialog
  1459. at the time the machine was started up.
  1460.  
  1461. Ñ  Home
  1462.  
  1463. This command lets you return to the home location while using any
  1464. application, without making Virtual Desktop active.  If the Virtual Desktop
  1465. application is not running, this will start it up.
  1466.  
  1467. Ñ  Name (various)
  1468.  
  1469. There is one command in this menu for each defined door.  Selecting a door
  1470. command causes Virtual Desktop to open the door.  If the Virtual Desktop
  1471. application is not running, this will start it up.
  1472.  
  1473. The Option key does not work with these commands, as it does with the
  1474. door commands in Virtual Desktop╒s Actions menu.
  1475.  
  1476.  
  1477.  
  1478. Limitations
  1479.  
  1480.  
  1481. You may occasionally find an application which does not work well with
  1482. Virtual Desktop, perhaps putting windows in places where you can╒t see
  1483. them, or not redrawing them when you scroll the desktop.
  1484. See the section entitled ╥Sensitive Applications╙ for more information on
  1485. how to recognize and deal with incompatible applications.
  1486.  
  1487. Here is a list of applications whose users have reported problems (not all
  1488. verified):
  1489. Ñ  Data Desk Professional [version 2.0] ╤ sporadic crashes when using
  1490. doors
  1491. Ñ  Brown tn3270 [version 2.3d28 or earlier] ╤ crashes if terminal
  1492. window goes entirely off-screen
  1493. Ñ  ColorSwitch [?] ╤ ?
  1494. Ñ  SmartCom II [version 3.3A, 3.4A, or 4.0A] - crashes if Virtual
  1495. Desktop Extension is installed
  1496. Ñ  Mathematica [version 2.2 Student Edition] - crashes if virtual desktop
  1497. is scrolled while calculating
  1498. Ñ  StuffIt Deluxe [version 3.0.7] - Magic Menu feature gets confused
  1499. about what to stuff
  1500. Ñ  Metrowerks CodeWarrior Debug 68K [?] - crashes while
  1501. single-stepping through code
  1502. Ñ  Empower [all versions] ╤ desktop doesn╒t redraw properly when
  1503. scrolling if screen cover option is on
  1504. Ñ  GraceLAN Server Manager [?] ╤ crashes if window goes entirely
  1505. off-screen
  1506. Ñ  Logitech MouseKey [version 1.2] ╤ crashes if window goes entirely
  1507. off-screen
  1508. Ñ  ResEdit [version 2.1.3 or earlier] ╤ color bitmap editors crash if
  1509. window goes entirely off-screen
  1510. The programs which crash if the window goes off-screen all have the
  1511. same programming error.  Even in the absence of Virtual Desktop, they
  1512. will crash if you drag the window╒s title bar to the very bottom of the
  1513. screen.
  1514.  
  1515. The Trash can may not always end up where you put it, because its
  1516. position is stored in the Finder Preferences file, not like the rest of the
  1517. desktop icons.  This is under investigation.
  1518.  
  1519. Having the ability to scroll the desktop, it would be nice if users could
  1520. keep an eye on a specific part of the virtual desktop at all times.
  1521. Currently, you have the option to exempt an application╒s windows from
  1522. scrolling, which you can use to keep its windows in view at all times.  The
  1523. proposed ╥watch windows╙╩scheme would let you select any rectangular
  1524. section of the virtual desktop and keep it in view in a floating window.
  1525.  
  1526. Another common request is for a miniaturized Full View floating window
  1527. which would offer a bird╒s-eye view of the changing virtual desktop
  1528. situation.  The current Full View window design forces you to block out
  1529. the desktop view to use it.
  1530.  
  1531. If you change the door to which an application╒s windows are anchored
  1532. using the Application Preferences dialog, the windows should be moved
  1533. automatically.  Currently, they are not.
  1534.  
  1535. You may store the Virtual Desktop Preferences file in a central location
  1536. and store aliases to it in various Preferences folders, but avoid storing it
  1537. on a server, as the Virtual Desktop extension will attempt to resolve the
  1538. alias during startup, and this may cause your Macintosh to hang.
  1539.  
  1540. Doors whose names begin with a period ('.') are not listed in the pop-up
  1541. menu associated with the Anchor Application╒s Items to Door option in the
  1542. Application Preferences dialog.
  1543.  
  1544.  
  1545.  
  1546. Acknowledgements
  1547.  
  1548.  
  1549. One big hug to Toni and the family for enduring a LOT of late nights.
  1550.  
  1551. Special thanks to the nearly 200 fine people who beta-tested this
  1552. software, and to others who provided useful information.
  1553.  
  1554.  
  1555.  
  1556. Revision History
  1557.  
  1558.  
  1559. 1.9 (March 6, 1996)
  1560. Ñ  Public AWOL Utilities 1.3 release.
  1561. Ñ  Added alerts offering to install the ╥Virtual Desktop Doors╙ Control
  1562. Strip module and ╥Quit Virtual Desktop╙ application in your System folder
  1563. after installing the ╥Virtual Desktop Extension╙ system extension, if
  1564. appropriate.  These files are now generated from inside the application,
  1565. not distributed alongside it.
  1566. Ñ  Added the Install menu, to let you install appropriate System folder
  1567. components at any time.
  1568. Ñ  Added support for the Display Manager, adjusting automatically when
  1569. you reconfigure your displays.
  1570. Ñ  Changed the Full View display so that windows rolled up using
  1571. WindowShade appear the same as hidden windows.
  1572. Ñ  Changed the effect of the ╥Switch to item via Finder╔╙ door option so
  1573. that scrolling happens before the item is opened, not after.  This makes it
  1574. more likely that the resulting windows will open in the right place.
  1575. Ñ  Improved the response to selections from the Door menu and Control
  1576. Strip module.
  1577. Ñ  Corrected a bug which left an unusable extension file in the Extensions
  1578. folder if installation failed due to Gatekeeper virus protection.  The
  1579. previous fix (in 1.8) was not completely successful.  This version also
  1580. reports the evidence of an earlier failed installation, and how to fix it.
  1581. Ñ  Corrected a bug which affected the appearance of menus and color
  1582. dialogs on Power Macintoshes.
  1583. Ñ  Corrected a bug which caused Virtual Desktop to present some alerts
  1584. while in the background.
  1585.  
  1586. 1.8 (October 17, 1994)
  1587. Ñ  Public AWOL Utilities 1.2 release.
  1588. Ñ  Added the optional Door menu, allowing easy access to doors from any
  1589. application, even if the Virtual Desktop application is not running.
  1590. Ñ  Added the ╥Virtual Desktop Doors╙ Control Strip module.
  1591. Ñ  Added the Shove Mouse usage option, a much-wanted bit of mimicry.
  1592. Ñ  Enhanced the usage options for more flexible selection of modifier keys.
  1593. Ñ  Added a usage option to suppress the scroll bar windows.
  1594. Ñ  Added a usage option to choose between half- and full-screen scrolling.
  1595. Ñ  Added a door option to open an arbitrary item via Finder when the door
  1596. is opened.
  1597. Ñ  Added a door option to change the color depth when the door is opened.
  1598. Ñ  Changed minimum virtual desktop padding from half a screenful to zero,
  1599. allowing more detail in Full View mode.
  1600. Ñ  Corrected a bug which could cause white-on-white or black-on-black
  1601. printing of names in door icon windows.
  1602. Ñ  Corrected a bug which left an unusable extension file in the Extensions
  1603. folder if installation failed due to virus protection.
  1604. Ñ  Corrected a bug in the Door Preferences dialog which could cause a
  1605. crash on Macintoshes without Color QuickDraw.
  1606. Ñ  Added the ╥Quit Virtual Desktop╙ application for use in the Shutdown
  1607. Items folder to assist Virtual Desktop by making it quit before all other
  1608. applications.
  1609.  
  1610. 1.7 (March 28, 1994)
  1611. Ñ  Public AWOL Utilities 1.1 release.
  1612. Ñ  Corrected a bug which could cause keystrokes normally trapped by
  1613. other system extensions to reach the active application.
  1614.  
  1615. 1.6.1 (March 27, 1994)
  1616. Ñ  Added choice of door arrangements to the ╥New Door╔╙ dialog.
  1617. Ñ  If the Virtual Desktop application crashes and is re-opened, it does not
  1618. lose track of the true home location, and refrains from moving other
  1619. applications╒ windows as it normally would.
  1620. Ñ  Corrected a bug which could cause a switch to another application when
  1621. placing a new door.
  1622. Ñ  Added an optional confirmation alert to the ╥Trash Door╙ menu
  1623. command.
  1624. Ñ  Corrected a bug which could misplace desktop icons if the Exempt
  1625. Application╒s Items From All Scrolling option were selected for desktop
  1626. icons.
  1627. Ñ  Improved performance of the Use Key Combination option.
  1628.  
  1629. 1.6.0 (March 13, 1994)
  1630. Ñ  Corrected a bug which caused disk drives to access periodically while
  1631. Virtual Desktop Extension was installed.
  1632. Ñ  Corrected a bug which could cause the About dialog to crash on
  1633. Macintoshes without Color QuickDraw.
  1634. Ñ  Added a Help button to the alert which asks for permission to install
  1635. Virtual Desktop Extension.
  1636. Ñ  Prevented Full View from using white as the color for an application╒s
  1637. item images and radio button.
  1638. Ñ  Added the ╥Rename Door╔╙ menu command and dialog.
  1639. Ñ  Added disabled item to the pop-up menu in the Application Preferences
  1640. dialog if the selected door no longer exists.
  1641. Ñ  Corrected a bug which prevented default application preferences set by
  1642. the user from overriding the built-in defaults.
  1643. Ñ  Prevented visible shifting of anchor and scroll bar windows when
  1644. opening, due to non-default layout preferences.
  1645. Ñ  Added the thank-you hot button under Acknowledgements.
  1646.  
  1647. 1.5.2 (February 27, 1994)
  1648. Ñ  Corrected a Virtual Desktop Extension bug which sometimes prevented
  1649. other applications from finding files.
  1650. Ñ  Corrected an incompatibility with SpeedyFinder7╒s Help menu removal
  1651. option which prevented help display.
  1652. Ñ  Virtual desktop growth is limited to 32,767 pixels in each direction.
  1653. Ñ  Added support for virtual desktop scrolling using the Home, End, Page
  1654. Up, and Page Down keys.
  1655. Ñ  Improved messages given when Virtual Desktop Extension is missing or
  1656. is out of date.
  1657. Ñ  Added protection against loading duplicate copies of the extension.
  1658. Ñ  Allowed the application to operate without a preferences file (for
  1659. example, when startup disk is locked).
  1660.  
  1661. 1.5.1 (February 7, 1994)
  1662. Ñ  Added virus protection removal advice to extension installation alert.
  1663. Ñ  Corrected a bug which could cause a crash on exit immediately after a
  1664. version check or extension installation alert.
  1665. Ñ  Corrected a bug which sometimes caused desktop icons to end up in the
  1666. wrong place.
  1667. Ñ  Desktop icons are properly handled in Systems whose language is other
  1668. than English.
  1669. Ñ  Increased minimum and preferred memory sizes to accommodate
  1670. PowerBook computers.
  1671.  
  1672. 1.5.0 (January 30, 1994)
  1673. Ñ  Added Virtual Desktop Extension to improve compatibility with other
  1674. programs.
  1675. Ñ  If the Shift key is pressed on startup, the extension will not be loaded.
  1676. If the Help or Command-? key is pressed, the extension will delay up to
  1677. one second to let the user release the key(s).
  1678.  
  1679. 1.4.1 (January 19, 1994)
  1680. Ñ  If the help server is absent when Virtual Desktop requests help, and the
  1681. user agrees to save the help file as a TeachText document, the file is split
  1682. into two parts small enough for TeachText to handle.
  1683. Ñ  Improved handling of desktop icons.
  1684.  
  1685. 1.4.0 (October 2, 1993)
  1686. Ñ  Initial AWOL Utilities 1.0 release.
  1687.